home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / relnotes / performer_eoe / ch2.z / ch2
Encoding:
Text File  |  1997-08-01  |  13.9 KB  |  396 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information supplemental to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product-specific; use it with the Installation Guide to
  13.        install this product.
  14.  
  15.        If you are installing Patch SG0001696 then you should take
  16.        note of the special instructions at the end of this chapter.
  17.  
  18.  
  19.        2.1  _S_p_e_c_i_a_l__N_o_t_e__f_o_r__t_h_o_s_e__r_u_n_n_i_n_g__I_R_I_S__P_e_r_f_o_r_m_e_r__2_._1
  20.  
  21.  
  22.        The Performer2.0.4 release includes compatibility subsystems
  23.        to update the 2.0-2.0.1 compatibility libraries that were
  24.        shipped in IRIS Performer 2.1.  Additionally,  IRIS
  25.        Performer 2.0.4 includes 2.1.2 compatibility subsystems to
  26.        update the 2.1 eoe DSOs with some bug fixes.  If you are
  27.        running IRIS Performer2.1, you need only install the
  28.        "compat" subsystems listed below. The other subsystems
  29.        aren't required.  These subsystems are:
  30.  
  31.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__0
  32.             IRIS GL and OpenGL 2.0.4 DSOs
  33.  
  34.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__0
  35.             IRIS GL and OpenGL 2.0.4 DSOs (n32)
  36.  
  37.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__0
  38.             OpenGL 2.0.4 DSOs (n64)
  39.  
  40.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__1
  41.             OpenGL 2.1.2 DSOs
  42.  
  43.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__1
  44.             OpenGL 2.1.2 DSOs (n32)
  45.  
  46.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__1
  47.             OpenGL 2.1.2 DSOs (n64)
  48.  
  49.  
  50.        2.2  _I_R_I_S__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m_s
  51.  
  52.        Several subsystems comprise the IRIS Performer 2.0.4
  53.        execution distribution of IRIS Performer.  These subsystems
  54.        are not all required for a proper installation.
  55.  
  56.        There are OpenGL and IRIS GL versions of the GL-specific
  57.        Performer libraries -- these are the two GL-types supported
  58.        by this release.  This environment supports both optimized
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        (compiled "-O2" for performance) and debug (compiled "-g"
  75.        for full symbol table and stack trace support) versions of
  76.        each dynamic shared object (DSOs or ".so" files). This
  77.        environment also spans two machine architecture levels --
  78.        the 32-bit MIPS I/II instruction set and the 64-bit MIPS
  79.        III/IV instruction set -- along with two versions of 32-bit
  80.        support -- the old caller-save register management protocol
  81.        known as Old-32 (O32)  and the newer callee-save register
  82.        management protocol termed New-32 (N32). For OpenGL, there
  83.        are actually three versions of each library: O32 MIPS II,
  84.        N32 MIPS III, and N64 MIPS III; IRIS GL only includes the
  85.        O32 and N32 libraries. The _f_i_l_e2 IRIX shell command can tell
  86.        you what version of the MIPS instruction set is being used
  87.        by a given executable.
  88.  
  89.        This multidimensional complexity is hidden within IRIS
  90.        Performer since the APIs are unchanged between the versions.
  91.  
  92.        The subsystem naming conventions are designed to be simple
  93.        and regular:
  94.  
  95.           +o Old-32 32-bit libraries are the default and are in
  96.             ".sw" subsystems.  These are marked for default
  97.             installation.
  98.  
  99.           +o New-32 32-bit libraries are in ".sw32" subsystems.
  100.             These are only useful on IRIX 6.2 and later operating
  101.             system releases.
  102.  
  103.           +o New-64 64-bit libraries are in ".sw64" subsystems.
  104.             These are only useful on IRIX 6.2 and later operating
  105.             system releases.
  106.  
  107.           +o IRIS GL libraries have ".igl" subsubsystem name
  108.             components. For best performance, use IRIS GL on
  109.             RealityEngine and all previous graphics systems.
  110.  
  111.           +o OpenGL libraries have ".ogl" subsubsystem name
  112.             components. For best performance, use OpenGL on Impact
  113.             and all subsequent graphics systems.
  114.  
  115.           +o Optimized libraries are the default and have no special
  116.             name. For best performance, always use the optimized
  117.             Performer libraries.
  118.  
  119.        A few simple examples should make this clear:
  120.  
  121.           +o performer_eoe.sw.igl_performer: O32, IRIS GL,
  122.             Optimized, DSO
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.           +o performer_eoe.sw32.ogl_performer: N32, OpenGL, DSO
  141.  
  142.           +o Note that this example illustrates a subtlety not
  143.             mentioned in the rules above -- since only OpenGL is
  144.             supported in 64-bit modes, all GL-specific 64-bit
  145.             subsystems are inherently OpenGL in nature.
  146.  
  147.        IRIS Performer eoe includes these subsystems whose names
  148.        were composed following the conventions outlined above:
  149.  
  150.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r
  151.             GL-independent DSOs
  152.  
  153.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._i_g_l__p_e_r_f_o_r_m_e_r
  154.             IRIS GL DSOs
  155.  
  156.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._o_g_l__p_e_r_f_o_r_m_e_r
  157.             OpenGL DSOs
  158.  
  159.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_1__2
  160.             Performer 1.2 Compatibility DSOs
  161.  
  162.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__0
  163.             Performer 2.0.4 Compatibility DSOs to update previous
  164.             2.0 compatibility subsystems
  165.  
  166.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__0
  167.             Performer 2.0.4 Compatibility DSOs for Performer 2.0
  168.             (n32)
  169.  
  170.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__0
  171.             Performer 2.0.4 Compatibility DSOs for Performer 2.0
  172.             (n64)
  173.  
  174.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__1
  175.             Performer 2.1.2 Compatibility DSOs for Performer 2.1
  176.  
  177.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__1
  178.             Performer 2.1.2 Compatibility DSOs for Performer 2.1
  179.             (n32)
  180.  
  181.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__1
  182.             Performer 2.1.2 Compatibility DSOs for Performer 2.1
  183.             (n64)
  184.  
  185.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r
  186.             GL-independent DSOs (n32)
  187.  
  188.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._i_g_l__p_e_r_f_o_r_m_e_r
  189.             IRIS GL DSOs (n32)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._o_g_l__p_e_r_f_o_r_m_e_r
  207.             OpenGL DSOs (n32)
  208.  
  209.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r
  210.             OpenGL DSOs (n64)
  211.  
  212.        Debugging DSOs and libraries for static linking are shipped
  213.        as part of the performer_dev product.
  214.  
  215.  
  216.        2.3  _I_R_I_S__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  217.  
  218.        This section lists the subsystems (and their sizes) of the
  219.        IRIS Performer option.
  220.  
  221.        If you are installing this option for the first time, the
  222.        subsystems marked ``default'' are the ones that are
  223.        installed if you use the ``go'' menu item.  To install a
  224.        different set of subsystems, use the ``install,''
  225.        ``remove,'' ``keep,'' and ``step'' commands in _s_w_m_g_r or _i_n_s_t
  226.        to customize the list of subsystems to be installed, then
  227.        select the ``go'' action.
  228.  
  229.        Note:  The listed subsystem sizes are approximate. Refer to
  230.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  231.               on finding exact sizes.
  232.  
  233.        Subsystem Name                                Subsystem Size
  234.                                                      (1k-byte blocks)
  235.  
  236.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_1__2                   2120
  237.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__0                  15436
  238.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t._p_e_r_f_o_r_m_e_r_2__1                  15584
  239.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__0                15080
  240.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__1                17096
  241.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__0                 9260
  242.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__1                10524
  243.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r (default)          384
  244.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._d_e_m_o (default)                     9032
  245.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._i_g_l__p_e_r_f_o_r_m_e_r (default)            6932
  246.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._o_g_l__p_e_r_f_o_r_m_e_r (default)            6948
  247.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r                  424
  248.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._i_g_l__p_e_r_f_o_r_m_e_r                    6324
  249.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._o_g_l__p_e_r_f_o_r_m_e_r                    6364
  250.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r                        7676
  251.        _p_e_r_f_o_r_m_e_r__d_a_t_a._d_a_t_a._a_s_d_d_a_t_a                        22104
  252.        _p_e_r_f_o_r_m_e_r__d_a_t_a._d_a_t_a._d_a_t_a (default)                 26676
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                   - 5 -
  268.  
  269.  
  270.  
  271.        2.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  272.  
  273.        All of the IRIS Performer subsystems can be installed using
  274.        IRIX.  You do not need to use the miniroot.  Refer to the
  275.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  276.        instructions. Detailed information about both the _s_w_m_g_r and
  277.        _i_n_s_t installation management tools is available through the
  278.        _m_a_n and _x_m_a_n commands.
  279.  
  280.        2.5  _P_r_e_r_e_q_u_i_s_i_t_e_s
  281.  
  282.        To use the IRIS Performer 2.0.4 execution environment, your
  283.        system must be running IRIX 6.3 or later.  To use the 64-bit
  284.        MIPS III/IV extensions, you must use IRIX 6.2 or a later
  285.        operating system release. In order to develop MIPS-III/IV
  286.        applications you must also install the appropriate selection
  287.        of N32 and N64 subsystems as listed above. IRIS Performer
  288.        developers will also need a C or C++ compiler, the loader,
  289.        and associated software development tools.
  290.  
  291.  
  292.        2.6  _C_o_m_p_a_t_i_b_i_l_i_t_y
  293.  
  294.        Applications compiled with the IRIS Performer 2.0 DSOs will
  295.        run unmodified with the IRIS Performer 2.0.4 DSOs across all
  296.        SGI platforms.  Applications compiled with the IRIS
  297.        Performer 2.1 DSOs will run  unmodified with the IRIS
  298.        Performer 2.1.2 DSOs.  Statically linked applications will
  299.        not be able to make use of the new DSOs in this release.
  300.        Such applications can be dynamically recompiled.  The minor
  301.        version number of the IRIS Performer 2.0.4 and 2.1.2 DSOs
  302.        have been incremented so that the new version numbers,
  303.        sgi2.3 and sgi3.1, can be differentiated from that in the
  304.        2.0 and 2.1 DSOs, respectively.
  305.  
  306.  
  307.        2.7  _I_n_s_t_a_l_l_a_t_i_o_n__L_o_c_a_t_i_o_n_s
  308.  
  309.        The IRIS Performer execution environment places DSOs under
  310.        "/_u_s_r/_l_i_b".
  311.        The compiled versions of the database loading and utility
  312.        libraries are placed under "/_u_s_r/_l_i_b/_l_i_b_p_f_d_b".
  313.        These libraries are dynamically loaded and must be
  314.        accessible for IRIS Performer 2.0.4 applications to
  315.        successfully execute unless they have been compiled with
  316.        static version of all database loading libraries that they
  317.        will need.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                   - 6 -
  334.  
  335.  
  336.  
  337.        2.8  _S_p_e_c_i_a_l__I_n_s_t_r_u_c_t_i_o_n_s__f_o_r__i_n_s_t_a_l_l_i_n_g__o_f__P_a_t_c_h__S_G_0_0_0_1_6_9_6
  338.  
  339.        Being a patch, Patch SG0001696 contains different subsystem
  340.        names then those listed for IRIS Performer 2.0.4.  However,
  341.        there is a simple rule to translate the subsystem names.
  342.        For every IRIS Performer 2.0.4 subsystem with a name in the
  343.        form performer_eoe.xxx.yyy there is a Patch SG0001696
  344.        subsystem with a name in the form
  345.        patchSG0001696.performer_eoe_xxx.yyy.
  346.  
  347.        Patch SG0001696 can be installed on top of either IRIS
  348.        Performer 2.0, 2.0.1, 2.0.2, or 2.0.3.  However because IRIS
  349.        Performer subsystems were renamed in these releases you man
  350.        need to manually select the subsystems you want to install
  351.        and set rulesoverride to true inside _s_w_m_g_r or _i_n_s_t to force
  352.        it to install these subsystems.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.